Hop til hovedindhold

BRS023

BRS023 is the DataHub integration point for requesting and receiving validated measure data.

It comprises the following message families:

  • RSM015 RequestValidatedMeasureData
  • RSM015 RejectRequestValidatedMeasureData
  • RSM012 NotifyValidatedMeasureData

Within the target architecture, BRS023 is a single cohesive integration slice with both outbound and inbound responsibilities.

Outbound integration: RSM015 RequestValidatedMeasureData​

Purpose​

This message requests validated measure data from DataHub.

Ownership​

  • Application decides when validated measure data must be requested
  • Infrastructure builds and sends the RSM015 transport document

Target flow​


Application use case or event handler

-> prepares request data

-> Infrastructure builds RequestValidatedMeasureData document

-> Infrastructure serializes document to JSON

-> Infrastructure posts to configured RSM015 endpoint

Infrastructure responsibilities​

  • create the generated root transport document
  • populate sender/receiver identifiers and roles
  • populate business sector, process type, and message type
  • apply DataHub-required defaults such as coding scheme
  • format timestamps correctly
  • serialize and submit the document

Builder seam​

RequestValidatedMeasureDataDocumentFactory is the target internal builder for the RSM015 document. Its responsibility is to construct the generated transport object for the outbound message.

It is kept internal because:

  • it is an Infrastructure detail
  • it should not become an application contract
  • it isolates DataHub-specific document construction from orchestration

Inbound integration: RSM015 RejectRequestValidatedMeasureData​

Purpose​

This message represents a rejection of an RSM015 request.

Target flow​


Infrastructure receives reject message
-> deserializes to generated RSM015 reject contract
-> RejectRequestValidatedMeasureDataHandler interprets the document
-> maps the rejection to an application command
-> Application handles the business consequence

Responsibilities​

  • Infrastructure understands the reject transport structure
  • Application handles the business effect of the rejection

Inbound integration: RSM012 NotifyValidatedMeasureData​

Purpose​

This message provides the validated measure data requested through BRS023.

Target flow​


Infrastructure receives notification
-> deserializes to generated RSM012 contract
-> NotifyValidatedMeasureDataHandler interprets the document
-> maps document contents to application command(s)
-> Application processes the validated measure data

Responsibilities​

  • Infrastructure owns message parsing and transport mapping
  • Application owns the business processing of the received data

BRS023 contract ownership​

All generated contracts for BRS023:

  • are stored under the BRS023 integration structure
  • are internal
  • are used only by Infrastructure
  • are not passed into Domain
  • are not treated as application DTOs